GrapeCity CalendarGrid for Windows Forms 3.0J
入力可能な範囲を設定する(CalendarGcTimeSpanCellType)

CalendarGcTimeSpanCellType に入力範囲を設定する方法について説明します。


MaxValue、MinValueプロパティを使用

CalendarGcTimeSpanCellType.MaxDate、CalendarGcTimeSpanCellType.MinDate、CalendarGcTimeSpanCellType.MaxMinBehaviorプロパティを使用します。

セルのMaxValueプロパティとMinValueプロパティを設定してセルに入力可能な範囲を指定します。全てのフィールドの値が入力されると検証が行われ、範囲外の場合にはMaxMinBehaviorプロパティの設定によって、値が制御されます。

【設定手順】

  1. CalendarGcTimeSpanCellTypeのMaxValue、MinValueプロパティに最大値、最小値を設定します。
  2. CalendarGcTimeSpanCellTypeのMaxMinBehaviorプロパティを設定します。既定値はAdjustToMaxMinです。

    MaxMinBehaviorの値 説明

    AdjustToMaxMin

    値を最小値か最大値の近い方に設定します。

    Clear

    値を削除してnull にします。

    Restore

    変更前の値に戻します。

    CancelInput

    最後の入力をキャンセルしてフォーカスを保持します。

    Keep

    エラーとなったText プロパティの値を保持します。

MaxMinBehaviorプロパティをCancelInputに設定した場合、範囲外の最後の入力を行った時点でGcTimeSpan.InvalidInputイベントが発生します。
InvalidInputイベント側では入力された値が範囲外であることを取得できるため、メッセージを出力するなどのカスタマイズが可能です。

以下のサンプルコードは、範囲外の値が入力されたとき、メッセージボックスを表示する例です。

Imports GrapeCity.Win.CalendarGrid
Imports InputManCell = GrapeCity.Win.CalendarGrid.InputMan
Imports CalendarGridInputMan = GrapeCity.Win.CalendarGrid.Editors

Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load
    Dim today As DateTime = DateTime.Today

    Dim GcTimeSpanCellType As New InputManCell.CalendarGcTimeSpanCellType()
    ' 最大値と最小値を設定します。
    GcTimeSpanCellType.MaxValue = TimeSpan.Parse("1.00:00:00")
    GcTimeSpanCellType.MinValue = TimeSpan.Parse("00:00:00")

    ' 範囲外の場合に値をどのように制御するかを設定します。
    GcTimeSpanCellType.MaxMinBehavior = InputMan.MaxMinBehavior.CancelInput

    GcCalendarGrid1.Content(today).Rows(1).Cells(0).CellType = GcTimeSpanCellType
    GcCalendarGrid1.ScrollIntoView(today)

    AddHandler GcCalendarGrid1.EditingControlShowing, AddressOf GcCalendarGrid1_EditingControlShowing
End Sub

Private Sub GcCalendarGrid1_EditingControlShowing(sender As Object, e As CalendarEditingControlShowingEventArgs)
    If TypeOf e.Control Is CalendarGridInputMan.GcTimeSpan Then
        Dim editor As CalendarGridInputMan.GcTimeSpan = DirectCast(e.Control, CalendarGridInputMan.GcTimeSpan)

        RemoveHandler editor.InvalidInput, AddressOf editor_InvalidInput
        AddHandler editor.InvalidInput, AddressOf editor_InvalidInput
    End If
End Sub

Private Sub editor_InvalidInput(ByVal sender As System.Object, ByVal e As System.EventArgs)
    Dim InvalidInputEventArgs As CalendarGridInputMan.InvalidInputEventArgs = TryCast(e, CalendarGridInputMan.InvalidInputEventArgs)
    If InvalidInputEventArgs Is Nothing Then
        Exit Sub
    End If

    ' 値が範囲外の場合には、メッセージを表示します。
    If InvalidInputEventArgs.ValueOutOfRange Then
        MessageBox.Show("範囲外の値です。")
    End If
End Sub
using GrapeCity.Win.CalendarGrid;
using InputManCell = GrapeCity.Win.CalendarGrid.InputMan;
using CalendarGridInputMan = GrapeCity.Win.CalendarGrid.Editors;

private void Form1_Load(object sender, EventArgs e)
{
    var today = DateTime.Today;

    var gcTimeSpanCellType = new InputManCell.CalendarGcTimeSpanCellType();

    // 最大値と最小値を設定します。
    gcTimeSpanCellType.MaxValue = TimeSpan.Parse("1.00:00:00");
    gcTimeSpanCellType.MinValue = TimeSpan.Parse("00:00:00");

    // 範囲外の場合に値をどのように制御するかを設定します。
    gcTimeSpanCellType.MaxMinBehavior = InputManCell.MaxMinBehavior.CancelInput;

    gcCalendarGrid1.Content[today].Rows[1].Cells[0].CellType = gcTimeSpanCellType;
    gcCalendarGrid1.ScrollIntoView(today);

    gcCalendarGrid1.EditingControlShowing += gcCalendarGrid1_EditingControlShowing;
}

private void gcCalendarGrid1_EditingControlShowing(object sender, CalendarEditingControlShowingEventArgs e)
{
    if (e.Control is CalendarGridInputMan.GcTimeSpan)
    {
        CalendarGridInputMan.GcTimeSpan editor = (CalendarGridInputMan.GcTimeSpan)e.Control;

        editor.InvalidInput -= editor_InvalidInput;
        editor.InvalidInput += editor_InvalidInput;
    }
}

private void editor_InvalidInput(object sender, EventArgs e)
{
    CalendarGridInputMan.InvalidInputEventArgs invalidInputEventArgs = e as CalendarGridInputMan.InvalidInputEventArgs;
    if (invalidInputEventArgs == null)
    {
        return;
    }

    // 値が範囲外の場合には、メッセージを表示します。
    if (invalidInputEventArgs.ValueOutOfRange)
    {
        MessageBox.Show("範囲外の値です。");
    }
}
関連トピック

 

 


© 2008 GrapeCity inc. All rights reserved.